package cn.ac.jaas.isc.vegetable.admin.mapper;

import cn.ac.jaas.isc.vegetable.admin.api.dto.UserDTO;
import cn.ac.jaas.isc.vegetable.admin.api.entity.SysUser;
import cn.ac.jaas.isc.vegetable.admin.api.vo.UserVO;
import cn.ac.jaas.isc.vegetable.common.data.datascope.DataScope;
import cn.ac.jaas.isc.vegetable.common.data.datascope.VegetableBaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * @author 张高昌
 * @date 2022/4/28 14:04
 * @description: 功能描述
 */
@Mapper
public interface SysUserMapper extends VegetableBaseMapper<SysUser> {

    /**
     * 通过用户名查询用户信息（含有角色信息）
     *
     * @param username 用户名
     * @return userVo
     */
    UserVO getUserVoByUsername(String username);

    /**
     * 分页查询用户信息（含角色）
     *
     * @param page      分页
     * @param userDTO   查询参数
     * @param dataScope
     * @return list
     */
    IPage<UserVO> getUserVosPage(Page page, @Param("query") UserDTO userDTO, DataScope dataScope);

    /**
     * 通过ID查询用户信息
     *
     * @param id 用户ID
     * @return userVo
     */
    UserVO getUserVoById(Integer id);

    /**
     * 查询用户列表
     *
     * @param userDTO   查询条件
     * @param dataScope 数据权限声明
     * @return
     */
    List<UserVO> selectVoListByScope(@Param("query") UserDTO userDTO, DataScope dataScope);
}
